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CP/M Asseirbler User's Guide 


1. INTRODUCTION. 


*016 CP/M assembler reads assembly language source files frotn the diskette, 
and produces 8080 machine language in Intel hex format. The CP/M assembler is 
initiated by typing 


or 


ASM filename 
ASM filename .parms 


In both cases, the assembler assumes there is a file on the diskette with the 
name 

filename .ASM 

%«hich contains an 8080 assembly language source file. The first and second 
forms shown above differ only in that the second form allows parameters to be 
passed to the assembler to control source file access and hex and print file 
destinations. 


In either case, the CP/M assembler loads, and prints the message 


CP/M ASSEMBLER VER n.n 


where n.n is the current version number. In the case of the first command, 
the assembler reads the source file with assumed file type “ASM** and creates 
two output files 


and 


filename.HEX 
filename.PRN 


the "HEX" file contains the machine code corresponding to the original program 
in Intel hex format, and the “PRN“ file contains an annotated listing showing 
generated machine code, error flags, and source lines. If errors occur during 
translation, they will be listed in the PRN file as well as at the console 


Hie second command form can be used to redirect input euid output files 
from their defaults. In this case, the "parms" portion of the command is a 
three letter group vhich specifies the origin of the source file, the 

destination of the hex file, and the destination of the print file. The form 
is 


filename.plp2p3 

where pi, p2, and p3 are single letters 

pi: A,B, ..., Y designates the disk name which contains 


1 




the source file 



p2: 

A,B, ..., Y 

designates the disk name which will re¬ 
ceive the hex file 



Z 

skips the generation of the hex file 


p3: 

A,B, ..., Y 

designates the disk name which will re¬ 
ceive the print file 



X 

places the listing at the console 



Z 

skips generation of the print file 

Thus, the 

command 




ASM 

X.AAA 


indicates 

that the 

source file 

(X.ASM) is to be taken from disk A, and 


the hex (X.HEX) and print (X.PRN) files are to be created also on disk A. 
This form of the command is implied if the assembler is run from disk A, That 
is, given that the operator is currently addressing disk A, the above command 
is equivalent to 


ASM X 


The command 


A9M X.ABX 

indicates that the source file is to be taken from disk A, the hex file is 
placed on disk B, and the listing file is to be sent to the console. The 
command 

ASM X.BZZ 

takes the source file from disk B, and skips the generation of the hex and 
print files (this command is useful for fast execution of the assembler to 
check program syntax), 

The source program format is compatible with both the Intel 8080 assembler 
(macros are not currently implement^ in the CP/M assembler, however), as well 
as the Processor Technology Software Package #1 assembler. That is, the CP/M 
assembler accepts source programs written in either format. There are certain 
extensions in the CP/M assembler v*iich make it somevhat easier to use. These 
extensions are described below. 

2. PROGRAM FORMAT. 

An assembly language program acceptable as input to the assembler consists 
of a sequence of statements of the form 

line# label operation operand ;comment 

where any or all of the fields may be present in a particular instance. Each 






''embly language statement is terminated with a carriage return and line feed 
(the line feed is inserted autcmatically by the ED program), or with the 
character ”!" v*iich is a treated as an end-of-line by the assentoler (thus, 
multiple assembly language statements can be written on the same physical line 
if separated by exclaim symbols). 

The line# is an optional decimal integer value representing the source 
program line number, which is allowed on any source line to maintain 
compatibility with the Processor Technology format. In general, these line 
numbers will be inserted if a line-oriented editor is used to construct the 
original program, and thus ASM ignores this field if present. 

The label field takes the form 


identifier 


or 


identifier: 


and is optional, except vbere noted in particular statement types. The 
identifier is a seguence of alphanumeric characters (alphabetics and numbers), 
where the first character is alphabetic. Identifiers can be freely used by 

the programmer to label elements such as program steps and assembler 
directives, but cannot exceed 16 characters in length. All characters are 
significant in an identifier, except for the embedded dollar symbol ($) which 
can be used to improve readability of the name. Further, all lower case 
alphabetics beccxne are treated as if they were upper case. Note that the 
following the identifier in a label is optional (to maintain compatibility 
between Intel and Prcxressor Technology). Itius, the following are all valid 

instances of labels 


xy long$name 

yxl: longer$named$data: 

Xlx2 x234$5678$9012$3456: 


X 

x: 


X1Y2 


The operation field contains either an assembler directive, or pseudo 
operation, or an 8080 machine operation code. The pseudo operations and 
machine operation codes are cJescribed below. 

The operand field of the statement, in general, cx^ntains an expression 
formed cxat of constants and labels, along with arithmetic and logical 
operations on these elements. ^y?ain, the complete cSetails of properly formed 
expressions are given below. 

The comment field contains arbitrary characters following the symbol 

until the next real or logical end-of-line. These characters are read, 
listed, and otherwise ignored by the assembler. In order to maintain 
compatability with the Processor Technology assembler, the CP/M assembler also 
treat statements which begin with a •'*" in column one as comment statements, 
which are listed and ignored in the assembly process. Note that the Processor 
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Technology assentoler has the side effect in its operation of ignoring the 
characters after the operand field has been scanned, Hiis causes an ambiguous 
situation v*ien attempting to be compatible with Intel's language, since 
arbitrary expressions are allowed in this case. Hence, programs v*iich use 
this side effect to introduce comments, must be edited to place a before 
these fields in order to assemble correctly. 

The assembly language program is formulated as a sequence of statements of 
the above form, terminated optionally by an END statement. All statements 
following the END are ignored by the assembler. 


3. FORMING THE CPERAND. 

In order to completely describe the operation codes and pseudo operations, 
it is necessary to first present the form of the operand field, since it is 
used in nearly all statements. Expressions in the operand field consist of 
simple operands (labels, constants, and reserved words), combined in properly 
formed scbacpressions by arithmetic and logical operators. The expression 
computation is carried out by the assembler as the assembly proceeds. Each 
expression must produce a 16-bit value during the assembly. Further, the 
number of significant digits in the result must not exceed the intended use. 
That is, if an expression is to be used in a byte move immediate instruction, 
then the most significant 8 bits of the expression must be zero. The 
restrictions on the expression significance is given with the individual 
instructions, 

3.1. Labels. 

As discussed above, a label is an identifier which occurs on a particular 
statement. In general, the label is given a value determined by the type of 
statement vbich it precedes. If the label occurs on a stateiment vbich 
generates machine code or reserves memory space (e.g, a MOV instruction, or a 
DS pseudo operation), then the label is given the value of the pmrogram address 
which it labels. If the label precedes an EQU or SET, then the label is given 
the value which results from evaluating the errand field. Except for the SET 
statanent, an identifier can label only one statement. 

When a label appears in the operand field, its value is substituted by the 
assaibler. This value can then be combined with other operands and operators 
to form the operand field for a particular instruction. 

3.2. Numeric Constants. 

A numeric constant is a 16-bit value in one of several bases. The base, 
called the radix of the constant, is denoted by a trailing radix indicator. 
The radix indicators are 

B binary constant (base 2) 

0 octal constant (base 8) 
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Q oc±al constant (base 8) 

D decimal constant (base 10) 

H hexadecimal constant (base 16) 


0 is an alternate radix indicator for octal nunbers since the letter 0 is 
easily confused with the digit 0, Any numeric constant which does not 
terminate with a radix indicator is assumed to be a decimal constant, 

A constant is thus composed as a sequence of digits, followed by an 
optional radix indicator, where the digits are in the ^propriate range for 
the radix. That is binary constants must be composed of 0 and 1 digits, octal 
constants c^ contain digits in the range 0-7, while decimal constants 
contain decimal digits. Hexadecimal constants contain decimal digits as well 
as hexadecimal digits A (10D), B (llD), C (12D), D (13D), E (14D), and F 
(ISD). Itote that the leading digit of a hexadecimal constant must be a 
decimal digit in order to avoid confusing a hexadecimal constant with an 
identifier (a leading 0 will always suffice). A constant composed in this 
manner must evaluate to a binary number which can be contained within a 16-bit 
counter, otherwise it is truncated on the right by the assembler. Similar to 
identifiers, imbedded are allowed within constants to improve their 

readability. Finally, the radix indicator is translated to upper case if a 
lower case letter is encountered. The following are all valid instances of 
numeric constants 


1234 1234D 1100B 1111$0000$1111$0000B 

1234H 0FFEH 33770 33$77$220 

33770 0fe3h 1234d 0ffffh 


3.3, Reserved Words. 

There are several reserved character sequences which have predefined 
meanings in the operand field of a statement. The names of 8080 registers are 
given below, which, when encountered, produce the value shown to the right 


7 

0 

1 

2 

3 

4 

5 

6 
6 
6 


A 

B 

C 

D 

E 

H 

L 

M 

SP 


PSW 


(again, lower case names have the same values as tbieir upper case 
equivalents). Machine instructions can also be used in the operand field, and 
evaluate to their internal codes. In the case of instructions which require 
operands, where the specific operand becomes a part of the binary bit pattern 
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oPi-fie instruction (e.g, MDV A,B), the value of the instruction (in this case 
MOV) is the bit pattern of the instruction with zeroes in the optional fields 
(e.g^ MDV produces 40H). 

When the syitbol occurs in the operand field (not inbedded within 
identifiers and numeric constants) its value becomes the address of the next 
instruction to generate, not including the instruction contained withing the 
current logical line. 

3.4. String Constants. 

String constants represent sequences of ASCII characters, and are 
represented by enclosing the characters within apostrophe symbols ('). All 
strings must be fully ccxitained within the current physical line (thus 
allowing "r* symbols within strings), and must not exceed 64 diaracters in 
length, "nie apostrophe character itself can be included wi^in a string by 
representing it as a double apostrophe (the two keystrokes "), vbich becomes 
a single apostrophe vben read by the assembler. In most cases, the string 
length is restricted to either one or two characters (the DB pseudo operation 
is an ecception), in vbich case the string becomes an 8 or 16 bit value, 
respectively. Two character strings becotne a 16-bit constant, with the second 
character as the low order byte, and the first character as the high order 
byte. 

The value of a character is its corresponding ASCII code. There is no 
case translation within strings, and thus both upper and lower case characters 
can be represented. Note however, that only graphic (printing) ASCII 
characters are allowed within strings. Valid strings are 

A AB ab c 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .0 
a 

'Walla Walla Wash.' 

'She said "Hello" to ime.' 

'I said ••Hello" to her.' 


3.5. Arithmetic and Logical Operators. 


The operands described above can be combined in normal algebraic notation 
using any combination of properly formed operands, operators, and 
parenthesized expressions. The operators recognized in the operand field are 


a + b 
a - b 
+ b 
- b 
a * b 
a / b 
a MDD b 
NOT b 


unsigned arithmetic sum of a and b 

unsigned arithmetic difference between a and b 

unary plus (produces b) 

unary minus (identical to 0 - b) 

unsigned magnitude multiplication of a and b 

unsigned magnitude division of a by b 

remainder after a / b 

logical inverse of b (all 0's become I's, I's 
become 0's), where b is considered a 16-bit value 
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a AND b bit-by-bit logical and of a and b 
a OR b bit-by-bit logical or of a and b 

a XOR b bit-by-bit logicl exclusive or of a and b 

a SHL b the value v^ich results from shifting a to the 
left by an amount b, witn zero fill 
a SHR b the value which results from shifting a to the 
right by an amount b, with zero fill 


In each case, a and b represent simple operands (labels, numeric 
constants, reserved words, and one or two character strings), or fully 
enclosed parenthesized subexpressions such as 


10+20 10h+37O 

{'a' and 5fh) + '0' 
(l+{2+c)) shr (A-(B+1)) 


LI /3 (L2+4) SHR 3 

('B'+B) OR (PSW+M) 


Note that all computations are performed at assembly time as 16-bit unsigned 
operations. Thus, -1 is computed as 0-1 which results in the value 0ffffh 
(i.e., all I's). The resulting expression must fit the operation code in 
which It is used. If, for example, the expression is used in a ADI (add 
immediate) instruction, then the high order eight bits of the expression must 
be zero. As a result, the operation "ADI -1" produces an error message (-1 
becomes 0ffffh v*iich cannot be represented as an 8 bit value) , v^iiile "ADI (-1) 
AND 0FFH" is accepted by the assembler since the "AND" operation zeroes the 
high order bits of the expression. 

3.6. Precedence of Operators. 

As a convenience to the programmer, ASM assumes that cperators have a 
relative precedence of application which allows the programmer to write 
expressions without nested levels of parentheses. The resulting expression 
has assumed parentheses vinich are defined by the relative precedence. The 
order of application of operators in unparenthesize expressions is listed 
below. Operators listed first have highest precedence (they are applied first 
in an mparenthesized expression), Oiile operators listed last have lowest 
precedence. Operators listed on the same line have egual precedence, and are 
applied from left to right as they are encountered in an expression 


*/ MOD SHL SHR 


NOT 
AND 
OR XOR 


Thus, the expressions shown to the left below are interpreted by the assembler 
as the fully parenthesize expressions shown to the right below 


a * b + c 
a + b * c 
a MDD b * c SHL d 


(a * b) + c 
a + (b * c) 

((a MOD b) * c) SHL d 
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a OR b AND NOT c + d SHL e a OR (b AND (NOT (c + (d SHL e)))) 

Balanced parenthesized subexpressions can always be used to override the 
assumed parentheses, and thus the last expression above could be rewritten to 
force application of operators in a different order as 

(a OR b) ?ND (NOT c) + d SHL e 

resulting in the assumed parentheses 

(a OR b) AND ((NOT c) + (d SHL e)) 

Note that , an inparenthesized expression is well-formed only if the expression 
which results from inserting the assumed parentheses is well-formed. 

4. ASSEMBLER DIRECTIVES. 

Assembler directives are used to set labels to specific values during the 
assnbly, perform conditional assembly, define storage areas, and specify 
starting addresses in the program. Each assembler directive is denoted by a 
"pseudo operation" vAiich appears in the operation field of the line. The 
acceptable pseudo operations are 


ORG 

set the program or data origin 

END 

end program, optional start address 

BQU 

numeric "equate" 

SET 

numeric "set" 

IF 

begin conditional assembly 

ENDIF 

end of conditional assembly 

DB 

define data bytes 

DW 

define data words 

D6 

define data storage area 


The individual pseudo operations are detailed below 
4.1. The ORG directive. 

The ORG statement takes the form 

label ORG expression 

where "label" is an optional program label, and expression is a 16-bit 
expression, consisting of op>erands which are defined previous to the ORG 
statement. The assembler begins machine code generation at the location 
specified in the expression. There can be any number of ORG statements within 
a particular program, and there are no checks to ensure that the programmer is 
not defining overlapping memory areas. Note that most programs written for 
the CP/M syst«n begin with an ORG statement of the form 

ORG 100H 
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which causes machine code generation to begin at the base of the CP/M 
transient program area. If a label is specified in the ORG statement, then 
the label is given the value of the expression (this label can then be used in 
the operand field of other statements to represent this expression). 

4.2. The END directive. 

The END statement is optional in an assembly language program, but if it 
is present it must be the last statement (all subsequent statements are 
ignored in the assembly). The two forms of the END directive are 

label END 

label END expression 

v^ere the label is again optional. If the first form is used, the assembly 
process stops, and the default starting address of the program is taken as 
0000. Otherwise, the expression is evaluated, and becomes the program 
starting address (this starting address is included in the last record of the 
Intel formatted machine code “hex'* file v*iich results from the assembly). 
Thus, most CP/M assembly language programs end with the statanent 

END 100H 

resulting in the default starting address of 100H (beginning of the transient 
program area). 

4.3. The EQU directive. 

The EQU (equate) statement is used to set up synonyms for particular 
numeric values, the form is 

label EQU expression 

where the label must be present, and must not label any other statement, "^e 
assembler evaluates the expression, and assigns this value to the identifier 
given in tlie label field. The identifier is usually a name which describes 
the value in a more human-oriented manner. Further, this name is used 
throughout the program to "parameterize" certain functions. Suppose for 
example, that data received from a Teletype appears on a particular input 
port, and data is sent to the Teletype through the next output port in 
sequence. Ihe series of equate statements could be used to define these ports 
for a particular hardware environment 

TTYBASE EQU 10H ;BASE PORT NUMBER FDR TTY 

TTYIN EQU TTYBASE ;TTY DATA IN 

TTYOOT EQU TTYBASE+1 ;TTY DATA OUT 

At a later point in the program, the statements which access the Teletype 
could appear as 
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IN TTYIN ;READ TIY DATA TO RBG-A 

OUT TIYOlTr ;WPITE EATA TO TTY FROM RBG-A 

making the program more readable than if the absolute i/o ports had been 
used. Further, if the hardware environment is redefined to start the Teletype 
communications ports at 7FH instead of 10H, the first statement need only be 
changed to 


TTYBASE BQU 7FH ;BASE PORT NUMBER FOR TTY 
and the program can be reassembled without changing any other statements, 

4.4, The SET' Directive, 

The SET statement is similar to the EQU, taking the form 
label SET expression 

except that the label can occur on other SET statements within the program. 
The expression is evaluated and becomes the current value associated with the 
label. Thus, the EQU statement defines a label with a single value, while the 
SET statement defines a value which is valid from the current SET statanent to 
the point where the label occurs on the next SET statement. The use of the 
SET is similar to the EQU statement, but is used most often in controlling 
conditional assembly, 

4.5, The IF and ENDIF directives. 

The IF and ENDIF statements define a range of assembly language statements 
which are to be included or excluded during the assembly process. The form is 

IF expression 

statement#! 

statement#2 

• • • 

statanenttn 

ENDIF 

Upon encountering the IF statement, the assembler evaluates the acpression 
following the IF (all operands in the expression must be defined ahead of the 
IF statement). If the expression evaluates to a non-zero value, then 
statement#! through statement#n are assembled; if the expression evaluates to 
zero, then the statements are listed but not assembled. Conditional assembly 
is often used to write a single ’‘generic" program which includes a number of 
possible run-time environments, with only a few specific portions of the 
program selected for any particular assembly. The following program segments 
for example, might be part of a program which communicates with either a 
Teletype or a CRT console (but not both) by selecting a particular value for 
TTY before the assembly begins 
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■muE 

BQU 

0FFFFH 

;DEFINE VALUE OF TRUE 

FALSE 

• 

BOU 

NOT TRIE 

;DEFINE VALUE OF FALSE 

§ 

TTY 

• 

BQU 

TRJE 

;TRJE.IF TTY, FALSE IF CRT 

TIYBASE 

BQU 

10H 

BASE OF TTY I/O PORTS 

CPTBASE 

BOU 

20H 

BASE OF CRT I/O PORTS 


IF 

TTY 

ASSEMBLE REIATIVE TO TTYBASE 

ODNIN 

BQU 

TTYBASE 

CONSOLE INPUT 

OONOOT 

BOU 

TTYBASE+1 

cor:soLE output 

• 

ENDIF 
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IF 

NOT TTY ; 

: ASSEMBLE RELATIVE TO CRTBASE 

OONIN 

BOU 

CRTBASE j 

^CONSOLE INPUT 

OONOUT 

BQU 

CKIBASE+l ; 

CONSOLE OUTPUT 


ENDIF 




• • • 

IN 

OONIN ; 

READ CONSOLE EATA 


• • • 

OUT 

OONOUT ; 

WRITE CONSOLE EATA 


In this case, the program would assemble for an environment where a Teletype 
is connected, based at port 10H. The statement defining TTY could be changed 
to 

TTY BQU FALSE 

and, in this case, the program would assemble for a CRT based at port 20H. 

4.6. The DB Directive. 

•Hie DB directive allows the programmer to define initialize storage areas 
in single precision (byte) format. The statement form is 

label DB e#l, e#2, ...» e#n 

\»here e#l through e#n are either expressions vhich evaluate to 8-bit values 
(the high order eight bits must be zero), or are ASCII strings of length no 
greater than 64 characters. There is no practical restriction on the number 
of Qcpressions included on a single source line. The expressions are 
evaluated and placed sequentially into the machine code file following the 
last program address generated by the assembler. String characters are 
similarly placed into memory starting with the first character and ending with 
the last character. Strings of length greater than two characters cannot be 
used as operands in more complicated expressions (i.e., they must stand alone 
between the commas). Note that ASCII characters are always placed in memory 
with the parity bit reset (0). Further, recall that there is no translation 
from lower to upper case within strings. The optional label can be used to 
reference the data area throughout the remainder of the program. Examples of 
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valid I» statanents are 


data: DB 0,lr2,3,4,5 

DB data and 0ffh,5,377O»l+2+3+4 
signon: DB 'please type your naine',cr,lf,0 
DB 'AB' SHR 8, 'C', 'DE' AND 7FH 


4,7. The DW Directive. 

The DW statement is similar to the DB statement except double precision 
(two byte) words of storage are initialized. The form is 

label DW e#l, e#2, ..., e#n 

vhere e#l through e#n are expressions which evaluate to 16-bit results. Note 
that ASCII strings of length one or two characters are allowed, but strings 
longer than two characters disallowed. In all cases, the data storage is 
caisistent with the 8080 processor; the least significant byte of the 
expression is stored forst in memory, followed by the most significant byte. 
Examples are 


doubt DW 0ffefh,doub+4,signon-$,255+255 

DW 'a', 5, 'ab', 'CD', 6 shl 8 or 11b 


4,8. The DS Directive. 

The DS statement is used to reserve an area of uninitialized memory, and 
takes the form 


label DS expression 

vhere the label is optional. The assembler begins subsequent code generation 
after the area reserved by the DS. Thus, the DS statanent given above has 
exactly the same effect as the statement 

label; EOU $ ;LABEL VALUE IS CURRENT CODE LOCATION 
ORG $4€Xpression ;MOVE PAST RESERVED AREA 


5. OPERATION CODES, 

Assahbly language operation codes form the fxrincipal part of assembly 
language programs, and form the operation field of the instruction. In 

general, ASM accepts all the standard imemonics for the Intel 8080 

microcomputer, which are given in detail in the Intel manual “8080 Assembly 
Language Programming Manual," Labels are optional on each input line and, if 
included, take the value of the instruction address immediately before the 
instruction is issued. The individual operators are listed breifly in the 
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following sections for completeness, although it is understood that the Intel 
manuals should be referenced for exact operator details. In each case, 

e3 represents a 3-bit value in the range 0-7 

viiich can be one of the predefined registers 
A, B, C, D, E, H, L, M, SP, or PSW. 

e8 represents an 8-bit value in the range 0-255 

el6 represents a 16-bit value in the range 0-65535 

which can themselves be formed from an arbitrary combination of operands and 
operators. In some cases, the operands are restricted to particular values 
within the allowable range, such as the PUSH instruction. These cases will be 
noted as they are encountered. 

In the sections which follow, each operation codes is listed in its most 

general form, along with a specific example, with a short explanation and 

special restrictions. 


5,1, Jumps, Calls, and Returns, 

Hie Jump, Call, and Return instructions allow several different forms 
which test the condition flags set in the 8080 microcomputer CPU. The forms 
are 


JMP 

el6 

JMP 

U 

Jump 

unconditionally to label 

JNZ 

el6 

JMP 

L2 

Jump 

on non zero condition to label 

JZ 

el6 

JMP 

100H 

Jump 

on zero condition to label 

JNC 

el6 

JNC 

U+4 

Jump 

no carry to label 

JC 

el6 

JC 

L3 

Jump 

on carry to label 

JPO 

el6 

JPO $+8 

Jump 

on parity odd to label 

JPE 

el6 

JPE 

L4 

Jump 

on even parity to label 

JP 

el6 

JP 

GAMMA 

Jump 

on positive result to label 

JM 

el6 

JM 

al 

Jump 

on minus to label 

CALL 

el6 

CALL SI 

Call 

subroutine unconditionally 

CNZ 

el6 

CNZ 

S2 

Call 

subroutine if non zero flag 

CZ 

el6 

CZ 

100H 

Call 

subroutine on zero flag 

CNC 

el6 

CNC 

Sl+4 

Call 

subroutine if no carry set 

CC 

el6 

CC 

S3 

Call 

subroutine if carry set 

CPO 

el6 

CPO 

$+8 

Call 

subroutine if parity odd 

ere 

el6 

ere 

S4 

Call 

subroutine if parity even 

CP 

el6 

CP 

GAMMA 

Call 

subroutine if positive result 

CM 

el6 

CM 

bl$c2 

Call 

subroutine if minus flag 

RST 

e3 

RST 

0 

Programmed "restart", equivalent to 





CALL 

8*e3, except one byte call 
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RET 

Return 

from subroutine 

FMZ 

Return 

if non zero flag set 

RZ 

Return 

if zero flag set 

RNC 

Return 

if no carry 

RC 

Return 

if carry flag set 

RPO 

Return 

if parity is odd 

RPE 

Return 

if parity is even 

RP 

Return 

if positive result 

RM 

Return 

if minus flag is set 


5.2. Immediate Operand Instructions. 

Several instructions are available vAiich load single or double precision 
registers, or single precision memory cells, with constant values, along with 
instructions vhich perform immediate arithmetic or logical operations on the 
accumulator (register A). 


MVI 

e3,e8 

MVI 

B,255 

ADI 

e8 

ADI 

1 

ACI 

e8 

ACI 

0FFH 

SUI 

e8 

SUI 

L + 3 

SBI 

e8 

SBI 

L »ID IIB 

ANI 

e8 

;tt]I 

$ AND 7FH 

XRI 

e8 

XRI 

1111$0000B 

ORI 

e8 

ORI 

L ?ND 1+1 

CPI 

e8 

CPI 

0 0 
a 

UCI 

e3,el6 

IXI 

B,100H 


Move inmediate data to register A, B, 

C, D, E, H, L, or M (memory) 

Add imm^iate operand to A without carry 
Add immediate operand to A with carry 
Subtract from A without borrow (carry) 
Siijtract from A with borrow (carry) 
Logical ''and" A with immediate data 
"Exclusive or" A with immediate data 
Logical "or" A with immediate data 
Compare A with immediate data (same 
as SUI except register A not changed) 

Load extended immediate to register pair 
(e3 must be equivalent to B,D,H, or SP) 




5.3. Increment and Increment Instructions. 

Instructions are provided in the 8080 repetoire for incrementing or 
decrementing single and double precision registers. The instructions are 


INR e3 

INR E 

Single precision increment register (e3 
produces one of A, B, C, D, E, H, L, M) 


DCR e3 

DCR A 

Single precision decrement register (e3 
produces one of A, B, C, D, E, H, L, M) 

. « 

INX e3 

INX SP 

Double precision increment register pair 
(e3 must be equivalent to B,D,H, or SP) 


DCX e3 

DCX B 

Double precision decrement register pair 
(e3 must be equivalent to B,D,H, or SP) 

m 


5.4. Data Movanent Instructions. 



14 







Instructions viiich move c3ata from memory to the CPU and from CPU to 
metory are given below 


MOV e3,e3 

MOV A,B 

Move data to leftmost element from right¬ 
most element (e3 produces one of A,B,C 
D,E,H,L, or M). MOV M,M is disallowed 

LDAX 

e3 

LCAX B 

Load register A from computed address 
(e3 must produce either B or D) 

STAX 

e3 

STAX D 

Store register A to computed address 
(e3 must produce either B or D) 

LHLD 

el6 

LHLD U 

Load HL direct from location el6 (double 
precision load to H and L) 

SHLD 

el6 

SHLD L5fx 

Store HL direct to location el6 (double 
precision store fran H and L to memory) 

LDA 

el6 

LDA Gamma 

Load register A from address el6 

STA 

el6 

STA X3-5 

Store register A into memory at el6 

POP 

e3 

POP PSW 

Load register pair from stack, set SP 
(e3 must produce one of B, D, H, or PSW) 

PUSH 

e3 

PUSH B 

Store register pair into stack, set SP 
(e3 must produce one of B, D, H, or PSW) 

IN 

e8 

IN 0 

Load register A with data from port e8 

OUT 

XTHL 

PCHL 

SPHL 

XCHG 

e8 

OUT 255 

Send data from register A to port e8 
Exchange data from top of stack with HL 
Fill program counter with data from HL 
Fill stack pointer with data from HL 
Exchange DE pair with HL pair 


5.5. Arithmetic Logic Unit Operations. 

Instructions vhich act upon the single precision accumulator to perform 
arithmetic and logic operations are 


ADD 

e3 

ADD 

B 

Add register given by e3 to accumulator 
without carry (e3 must produce one of A, 
B, C, D, E, H, or L) 

ADC 

e3 

ADC 

L 

Add register to A with carry, e3 as above 

SUB 

e3 

SUB 

H 

Subtract reg e3 from A without carry, 
e3 is defined as above 

SBB 

e3 

SBB 

2 

Subtract register e3 from A with carry, 
e3 defined as above 

ANA 

e3 

ANA 

1+1 

Logical “and" reg with A, e3 as above 

XPA 

e3 

XRA 

A 

"Exclusive or" with A, e3 as above 

ORA 

e3 

ORA 

B 

Logical "or" with A, e3 defined as above 

CMP 

CAA 

CMA 

STC 

e3 

CMP 

H 

Compare register with A, e3 as above 
Decimal adjust register A based upon last 
arithmetic logic unit operation 

Complement the bits in register A 

Set the carry flag to 1 
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CMC 


Complement the carry flag 

RLC 


Rotate bits left, (re)set carry as a side 
effect (high order A bit becomes carry) 

RRC 


Rotate bits right, (re)set carry as side 
effect (low order A bit becomes carry) 

RAL 


Rotate carry/A register to left (carry is 
involved in the rotate) 

RAR 


Itotate carry/A register bo right (carry 
is involved in the rotate) 

DAD e3 

DAD B 

Double precision add register pair e3 to 
HL (e3 must produce B, D, H, or SP) 


5.6. Control Instructions. 

The four reroaining instructions are categorized as control instructions, 
and are listed below 

Efalt the 8080 processor 
Disable the interrupt system 
Enable the interrupt system 
No operation 


HLT 

DI 

El 

NCP 



6 . 


ERROR MEISSAGES 



When errors occur within the assembly language program, they are listed as 
single character flags in the leftmost position of the source listing. The 
line in error is also echoed at the console so that the source listing need 
not be examined to determine if errors are present. The error codes are 


D Data error: element in data statement cannot be 

placed in the specified data area 

E Expression error: expression is ill-formed and 

cannot be computed at assembly time 


L 

N 


0 

P 


Label error: label cannot appear in this context 
(may be duplicate label) 

Not implemented: features which will appear in 
future ASM versions (e.g., macros) are recognized, 
but flagged in this version) 


Overflow: expression is too complicated (i.e., too 
many pending operators) to computed, simplify it 


Phase error: label does not have the same value on 
two subsequent passes through the program 
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R Register error; the value specified as a register 

is not compatible with the operation code 

V Value error: operand encountered in expression is 

improperly formed 


Several error message 
conditions 

are printed v^ich are due to terminal error 

NO SOURCE FILE PRESENT 

Ihe file specified in the ASM command does 
not exist on disk 

NO DIRECTORY SPACE 

The disk directory is full, erase files 
v*iich are not needed, and retry 

SOURCE FILE NAME ERROR 

Improperly formed ASM file name (e.g., it 
is specified with "?*’ fields) 

SOURCE FILE READ ERROR 

Source file cannot be read properly by the 
assembler, execute a TYPE to determine the 
point of error 

OUTPUT FILE WRITE ERROR 

Outpxjt files cannot be written properly, most 
likely cause is a full disk, erase and retry 

C/WNOT CLOSE FILE 

Output file cannot be closed, check to see 
if disk is write protected 

7. A SAMPLE SESSION. 



The following session shows interaction with the assembler and debugger in 
the development of a simple assembly language program. 
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ASH SORT^ S^rr.ftSH. 


CP/H ASSEMBLER - VER i.0 


015C VAAjct-frK . \ 

003H USE FACTOR % HaU< OS&i OO fF ^UcfiaeCivLiUj 
END OF ASSEMBLY 


DIR SORT.♦ 


SORT 
SORT 
SORT 
SORT 

A>TYPE SORT.PRN- 


ASM Saut<e -fiU 
B A K L*fnf t**^*j^'*** Iaj^" 

PRN "(bL 

HEX v\^acU<MC code. ^(e. 


Souut(.C 


vwtccUivtt cUe. ioocW 


SORT PROGRAM IN CP/M ASSEMBLY LANGUAGE 

START AT THE BEGINNING OF THE TRANSIENT PROGRAM AF- 


6100 

0100 

“- 

<)e>MAAW Code, 

2 1460 1*^ SORT: 

ORG 

LXI 


100H 

H. SU 

iADDRESS SWITCH TOGGLE 

0103 

3601 

MVI 


M, 1 

>SET TO 1 FOR FIRST ITERATION 

0105 

214701 

LXI 


H> I 

iADDRESS INDEX 

0106 

3600 

MVI 


M. 0 

; I = 0 


i 

i 

COMPARE 

I UITn 

ARRAY SIZE 

010A 

7E COMP. 

MOV 


A< M 

;A REGISTER => I 

010B 

FE09 

CPI 


H-1 

;CY SET IF I < < N-1) 

010D 

D21901 

JHC 


CONT 

^CONTINUE IF I <= (N-2> 


i 

i 

END 

OF ONE PASS 

THROUGH DATA 

0110 

214601 

LXI 


H. SU 

;CHECK FOR ZERO SWITCHES 

0 113 

7EB7C20001 

MOV 

A. N 1 

ORA A! 

JNZ SORT >EHD OF SORT IF SWa0 

0118 

i 

FF 

RST 

7 


iGO TO THE DEBUGGER INSTEAD OF RE 




runCA'jdl 


0119 5F16002148CONT: 
0121 4E792346 


CONTINUE THIS PASS 

ADDRESSING I> SO LOAD AV(I> INTO REGISTERS 
MOV E/A! MVI D,0! LXI H.AV! DAD D! DAD D 
MOV C/M! MOV A.C! INX H! MOV B..M 

LOU ORDER BYTE IN A AND Z. HIGH ORDER BYTE IN 6 


0125 23 

i 

i 

0126 96S778239E 

i 

i 

0126 DA3F01 


MOV H AND L TO ADDRESS AV<l4-l) 

INX H 

COMPARE VALUE WITH REGS CONTAINING AV<I> 

SUB M! MOV D,A! MOV A,9! INX H! SBB M iSUBTRACT 

BORROW SET IF AV<I+1> > AV<I) 

JC INCI iSKIP IF IN PROPER ORDER 


012E B2CA3F01 


CHECK FOR EQUAL VALUES 

ORA D! JZ IHfI ;SKIP IF AV<1) = AV<1+1> I? 








0132 

0136 


56702B5E 
7 12B722B73 


MOV Ii,(1! MOV M, B! DCX H! MOV E. f1 

MOV M,C! IlCX H! MOV M, D ! DCX H! MOV M.E 


013B 21460134 


INCREMENT SWITCH COUNT 
LX I H>SU! I NR M 


013F 2147B134C3INCI 


INCREMENT I 

LXI H.I! INR M! JMP COMP 


0146 
0147 
0148 
0008 
015C 
A>TYPE 


00 


SU: 

I : 

05006400lEPV: 
i N 

^ value. 

SORT^ HEX , 


DATA DEFINITION SECTION 

® .RESERVE SPACE FOR SWITCH COUNT 

I ;SPACE FOR INDEX 

5, 100.30.5 0.2 0,7, 1000. 300, 100, -32767 

EQU ($-AV)/2 ^COMPUTE N INSTEAD OF PR 

END 


:10010000214601360121470136007EFE09D21&0140 
. 1001100021460 17EB7C2000 IFF5F 16002 14801 1983 
: 10012000194E79234623965778239EDA3F01B2CAA 7 
100130003F0156702B5E712B722B732146013421C7 
07014000470134C30A01006E 
10014800050064001E00320014000700E8032C01BB , 
0401580064000180BE J 

0000000000 

A>DDT SORT. HEX-> vuv\_ 


yulicUiva. ctdt lA 


16K DDT VER 
NEXT PC 


V 

1 . 0 


N t X T PC 

015C 0000 o** 

-XP^ 


0jD slortcyneiji') 


P»0000 10 0^ 10(5 

-UFFFF^ 




C0ZOM0E0I0 

A=00 

B=0000 

D=0000 

H=0000 

S=0100 

P=0 1 00 

LXI 

H, 0146 •'0 100 







C0Z0M0E0I0 

A=:0 1 

B=>0000 

D=e000 

H=0146 

S=0100 

P=6100 

LXI 

H,0146 

C0Z0M0E0I0 

As0 1 

B-0000 

D=0O00 

H=0146 

S=0100 

P=0 103 

MVI 

M, 0 1 

C0Z0M0E0I0 

A-0 1 

B-8000 

D=0000 

H=0146 

S=0100 

P = 0 105 

LXI 

H,0147 

C0Z0M0E0I0 

A«0 1 

B»00ee 

D=0000 

H=0147 

S=0100 

P=0 103 

MVI 

M, 00 

C0Z0M0E0I0 

A = 0 1 

6=0000 

D=0000 

H=0147 

S=0100 

P = 0 10A 

MOV 

A. M 

C0Z0M0E0I0 

A»00 

B=0000 

D=0O00 

H=0147 

S=0100 

P=0 10B 

CPI 

09 

C1Z0M1E010 

A=00 

B=0000 

D=0000 

H=0147 

S=0100 

P=0 IdD 

JNC 

0 119 

C1Z0M1E0I0 

A = 00 

B=0000 

D=6000 

H=0147 

S=0100 

P==0110 

LXI 

H. .. 0 14 6 

C1Z0M1E0I0 

A»00 

B=0000 

D=0000 

H=0146 

S=0100 

P=0 11 3 

MOV 

A, M 

C1Z0M1E0I0 

A*01 

B=0000 

D=0000 

H=0146 

S=0100 

P-0114 

ORA 

A 

C0Z0M0EO10 

A»01 

6=0000 

D=0000 

H=0146 

S=0100 

P“0 11 5 

JNZ 

0 100 

C0Z0M0E0I0 

A»01 

B=0000 

D=0000 

H»0146 

S=0100 

P“0 100 

LXI 

H,0 146 

C0Z0M0E0I0 

A«01 

B=0000 

D=6000 

H>0146 

S=0100 

P=0 103 

MVI 

M, 0 1 

C0Z0M0E0I0 

A-01 

6=0000 

D=0000 

H=0146 

S=0100 

P=0 105 

LXI 

H, 014 7 

C0Z0M0E0I0 

A-0 1 

B=0000 

D=6000 

H=0147 

s =0100 

P=0 108 

MVI 

M, 0 0 

C0Z0M0E0I0 
-A10D 

A = 01 

B=0000 

D=60O0 

H = ej 4 7 

S=0100 

P= 010 A 

MOV 

A,Mf0108 

one/' “ 

ajuu^ 




? 







p«eieB lee 

p 

-Tie, -^roct. 

ti 

cezeHBEeie 

cezeneEeie 

cezeneEeie 

cezeneEeie 

cezeneEeie 

cezeneEeie 

cizeniEeie 

cizeniEeie 

cizeniEeie 

CizeniEeie 

CizeniEeie 

cezeniEeie 

cezeniEeie 


lOH S'kfS 


Io^c,(iinn0* 


cezeni ebi 0 

cezeniEeie 

cezeniEeie 

-L100^ 


eiee 

LXI 

9103 

nvi 

8105 

LXI 

0108 

nvi 

ei0A 

nov 

0108 

C0I 

010D 

JC 

01 le 

LXI 

0113 

nov 

01 14 

ORA 

0115 

JNZ 



81 18 

RST 

0119 

MOV 

01 lA 

HVI 

ei 1C 

LXI 


A»ee 

e=ee 

A=ee 

A-ee 

A-ee 

A=ee 

A-ee 

A»ee 

A<»ee 

A»ee 

A-ee 

A»ee 

A=ee 

A=ee 

A=e5 

A=e5 


B»eeee 

B==eeee 

B=eeee 

B-eeee 

B-eeee 

B-eeee 

B-eeee 

B-eeee 

B-eeee 

B=eeee 

B-eeee 

B-eeee 

B=ee00 

B^eees 

B^eees 

B»ee85 


D=eeee h = 
D=eeee h = 

D = B000 
D=00ee H' 
D^eeee 
D=eeee h 
D^eeee h 
ii=eeee h 
D=eeee h 
o»eeee h 
D^eeee h 
D^ eeee h 

D=0000 H 

o^eeee h 
D= 0eee h 
D-B eea h 


= ei 4P 
=ei 46 
= 0146 
= 0147 
= 0147 
= 0147 
= 01 47 
= 0147 
= 0147 
= 0147 
= ei 48 
= 0148 
= 0148 
= 0148 
= 0148 
= 0149 


s= 0 iee 

S=0100 
S=0100 
S=0100 

s=ei 00 

S=0l00 

s=ei 00 

S=0100 
S=0100 
S=0100 
8=0100 
8=0100 
8=0100 
8=0100 
8=0100 
8=0100 


Jr'frcfyam. 


=0100 LXI 
0 10 3 M V1 
0105 LXl 

= 0108 n VI 

=010A MOV 
010B CPl 
=0100 JC 
=0119 MOV 
»011A MVI 
=011C LXI 
=011F DAD 
0120 DAD 
=0121 MOV 
=0122 MOV 
=0123 INX 
=0124 MOV 


H,0146 

n, 01 

H.0 147 

n. 00 

A. n 

09 

0119 
H, 0146 
A> n 

A 

0 100 


A 






il6lr SOvxt 
-fvT*»A. IDOM 


J 


07 
E> A 
D. 00 
H> 0148 

" aU>v4 [M 




1^' 




H,0146 
M, 01 
H> 0 147 
M, 00 

A. n 

09 

0119 
E. A 
D> 00 
H.0 148 
D 
D 

M 

A< C 
H 

B. n«ei2s 






.r 


f 



^ ca/v6*t'?^ ^ 

^oyauA,-rnfw. curvv^ 

*0127 ua-H^ awt 7 

look ok loofii^ ^.^^4yoc« moii ^ 


•G.1 IB 


-T4 


T nw T'f**'! !*•»'»'» ' 

l^ocpivi^ iwlffi*w.4e.(^j 


D. A 
A/ B 


cezeneEeie A=3e B'»ee64 D^eeee H»ei56 s*ei00 0=0127 nov 

cezeneEeie a= 38 B=Be64 d» 3806 H»ei56 s=ei00 0=0128 nov 

cezeneEeie A=ee 8=0064 d»3806 h=0156 8=0100 0=0129 inx h 

C0Z0M0E010 A=00 8=0064 D=3806 H=0157 8=0100 0=012A SBB n*012B 

— cLchft. Sarjcdj 

0148 05 00 07 00 14 ee IE 00 , « ^ 

0150 32 ee 64 00 64 00 2C 01 E8 83 01 80 00 80 00 00 2 D D . 

0160 ee ee ee ee ee ee ee ee ee 00 00 00 00 ee ee 
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re+urA CP/w 


DDT SORT.HEX^ fcloAd io^a^ 


16K. DDT VER 1. 0 
NEXT PC 
01SC 0000 
-XP 


P = 0000 10 0 ^ SH "pc -lo cjf'pTMinWYl 


-L10D^ It-jt- lodJ, C^Coic 

010D JNC 0 119*^ 

0110 LXl H,0i46 

VA/i-tU fu(oouf 

- A 10 D^ Yiun opCtf«te. 


010D JC 119, 

jr 

0110^ 

- L 1 0 0^ ' 

0100 LXI H.0146 
0103 MVI M.01 
0105 LXI H,0147 
0108 MVI M.00 

cSooA. tvtH» 

-A 103^ cUxv^ SWi-i-ci^ VvA-vUo-lito-W^ 


5W*4>»4^ 5^c(u»^ oF 'S^oyOiAK 


0103 MVI M,0^ 

0105j 

-"C -V CP/m. u/i^ c.|('C. (&P as 

SAVE 1 SORT.COM 1 1 lOOK-blFPK) 6V\ CA?>«- 

u/€ Uavc. *W t"£lda4. 

A>DDT SORT. COM^ totHv 

5 dv /<4 ynev*'®'^ \YY\a^e 

16K DDT VER 1.0 

0^00 0^00 "CcM" filf- sWb lAji-H" a/Urta» lOOH 

*■ Gl^ ru.A-+W«- 'pVf^ro.iAA “PC^lClOH 

• 0110 -OvonyfOi^^^cl 5Wp C^f^) 

-D148 , 

cWbi •fiOrfcol 

0148 05 00 07 00 14 00 IE 00 .. 

0150 32 00 64 00 64 00 2C 01 E8 03 01 80 00 80 08 00 2 D D . 

0160 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0170 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 


“ fc{lKyiA. Cf/M. 






ED SORT. ASH ^ -\o (Vv4iv\^l 1>v^» 

c- ■ ^ 

*N,0r;^TT^ 

M U T M A 


V^>AA. 


^ HVl 

M .. 0 

i I * 0 


* V uf oAt line 

' LXI 

H. I 

/ADDRESS 

I NDEX 

* " j up rtn»H««r line. 

MVI 

M, 1 

iSET TO 1 

FOR FIRST ITERATION 

• K ViU lac fiod +1^ K4icl UiW' 
LXI H,I 

/ADDRESS 

INDEX 

• (v«<r<r ••w li«\c. 

MVI 

M. 0 

;ZER0 SU 


• NJNCy©^ 

JNC*T, 
COHT ^ 

H, I 

/ADDRESS 

I NDEX 

^CONTINUE IF I <= 

<N-2> 

• -zdicQblt^ 

JC 

CONT 

iCONTINUE 

IF I <= (H-2) 


*E 


/'^ufce^tm ^tikA 

/ lit)f\o Jiit A • 
ASM SORT. A A Z^sk\p f^n +.»« 


CP/M ASSEMBLER - VER 1 . 0 

ei5C Miik aiiiresi ■\o Oi^eJJic 
003H USE FACTOR 
END OF ASSEMBLY 


BDT SORT. HEX , •|e5f ^ajvajm cUa*^s 


ISK DDT VER 1 0 
NEXT PC 
015C 0000 
- G 1 0 ^ 


• 0118 
-D148^ 

0148 05 00 07 00 14 
0150 32 00 64 00 64 
0160 00 00 06 60 66 


00 

00 

00 


cU-fa 


IE 00 

2C 01 E8 03 01 80 00 00 

00 00 00 66 06 66 6vj 60 


00 002 D D . 

0 6 6 6 


- tucHi 



r(tV roc -bCPK- 


vawauA- Ot, 







c 



c 


J 


J 


J 


